@database SampleVisionDatatype.guide
@author "Frank Hoffmann"
@wordwrap
@node Main "Sample Vision Datatype document"
@{b}Sample Vision Datatype@{ub} - Public Release 1
Version 39.5 (27.12.1994)
(c) 1994 by Frank Hoffmann
@{" Installation, Requirements & Tested " link IRT }
@{" About the Sample Vision Fileformat  " link SVINFO }
@{" DISCLAIMER & LEGAL MATTERS          " link DISLEG }
@{" Features & TODO                     " link FEATODO }
@{" Known Bugs                          " link BUGS }
@{" ACKNOWLEDGEMENTS                    " link ACK }
@{" Author/Contact                      " link AUTHOR }
@endnode
@node IRT "INSTALLATION, REQUIREMENTS & TESTED"
This datatype is tested on a Amiga 4000 with Kickstart 3.1, but it should run on all machines with Kickstart 3.0 and above. Only 32Bit Prozessors (>=68020) are supported!.
To install just copy the files 
     SampleVision
     SampleVision.info 
@{ui}
to the drawer 
     sys:devs/datatypes
@{ui}
and the file
     SampleVision.datatype
@{ui}
to the drawer
     sys:classes/datatypes
@{ui}
and reboot your machine.
@endnode
@node SVINFO "Sample Vision Fileformat Information"
@{b}Sample Vision@{ub} is a special file format used by a tool on MS-DOS computers. It stores always mono samples in 16 Bit and can include 8 looppoints and markers. 
File Extension : #?.smp                   (not checked by datatype) 
Magic Number   : "SOUND SAMPLE DATA 2.1 " (checked by datatype)
@endnode
@node FEATODO "Features & TODO"
FEATURES
*Decode @{"Sample Vision" link SVINFO} file format to 8 bit sample data  
*Extracts name of sample if present and uses this name for the objects name
*Normalizes the 8bit data (which is musch quicker)
METHODS
*OM_New to read from file
(near future)
*Normalize the 16 bit data for better quality ( but is much slower )
*Looppoint extraction
*Low memory detection & low memory conversion
(maybe)
*Implement other methods (Write)
*Prefs and shared library for conversion & general behaviour of sound data-
 types, based on a sound support library wich can convert and process sample
 data. ( Feel free to contact me for suggestions and help offers ) 
OTHER DATATYPE PROJECTS
-Maud ( also released )
-MIDI Sample Dump Standard ( on work )
-Yamaha TX16W Sampler File ( also released )
@endnode
@node DISLEG "Disclaimer & legal matters"
DISCLAIMER
THERE  IS  NO  WARRANTY  FOR  THE  PROGRAM,  TO  THE EXTENT PERMITTED BY
APPLICABLE  LAW.   EXCEPT  WHEN  OTHERWISE  STATED IN WRITING THE COPYRIGHT
HOLDER  AND/OR OTHER PARTIES PROVIDE THE PROGRAM ''AS IS'' WITHOUT WARRANTY
OF  ANY  KIND,  EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
THE  IMPLIED  WARRANTIES  OF  MERCHANTABILITY  AND FITNESS FOR A PARTICULAR
PURPOSE.   THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
IS  WITH  YOU.   SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
   IN  NO  EVENT  UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
WILL  ANY  COPYRIGHT  HOLDER,  OR  ANY OTHER PARTY WHO MAY REDISTRIBUTE THE
PROGRAM  AS  PERMITTED  ABOVE,  BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
GENERAL,  SPECIAL,  INCIDENTAL  OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
USE  OR  INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
DATA  OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
PARTIES  OR  A  FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
EVEN  IF  SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
SUCH DAMAGES.
LEGAL MATTERS
This datatype is Public Domain. Do whatever you want with it. 
This datatype is based on the source code of the AIFF Datatype by 
Olaf 'Olsen' Barthel <olsen@sourcery.han.de> which is public domain.
@endnode
@node ACK "ACKNOWLEDGEMENT"
Many thanks to Olaf 'Olsen' Barthel for his help in designing datatypes.
@endnode 
@node BUGS "Bugs"
no known bugs (yet), but there is no 100% bug free software...
contact the @{" Author " link AUTHOR } for bug reports.
@endnode
@node AUTHOR "Author"
Frank Hoffmann
E-Mail (temporary):
hoffmann@ls11.informatik.uni-dortmund.de
permanent address:
Hochdahler Str.134
40724 Hilden
(feel free to contact me via E-Mail for bug reports, suggestions, projects...)
@endnode